home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / ecstats.z / ecstats
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. EEEECCCCSSSSTTTTAAAATTTTSSSS((((1111))))                                                          EEEECCCCSSSSTTTTAAAATTTTSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      eeeeccccssssttttaaaattttssss - report global event counter activity
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      eeeeccccssssttttaaaattttssss [----aaaaCCCCDDDDeeeeffffrrrr] [interval]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      eeeeccccssssttttaaaattttssss may be used on systems with R10000 processors to interrogate the
  16.      global event counters maintained by IRIX using the underlying hardware
  17.      event counter mechanisms.  The global event counters are maintained on a
  18.      system-wide basis, aggregated over all processes and for all user and
  19.      system mode execution.
  20.  
  21.      Global event counters are enabled and disabled using the eeeeccccaaaaddddmmmmiiiinnnn(1)
  22.      command.
  23.  
  24.      The options to _e_c_s_t_a_t_s are as follows;
  25.  
  26.      ----aaaa   Report absolute values for the event counters (the complement of
  27.           ----rrrr).
  28.  
  29.      ----CCCC   Enable full-screen and continuous update mode.  Single character
  30.           keystroke commands have the effect of toggling the command line
  31.           options, i.e.
  32.  
  33.           aaaa    change to reporting absolute counter values
  34.           eeee    report only the enabled counters
  35.           ffff    display both enabled and disabled counters
  36.           rrrr    change to reporting counter rates
  37.           qqqq    exit
  38.           ^^^^LLLL   redraw the display
  39.  
  40.      ----DDDD   Enable some diagnostic output, not useful with ----CCCC.
  41.  
  42.      ----eeee   Display only those event counters that have been enabled - this is
  43.           the default.
  44.  
  45.      ----ffff   Display both enabled and disabled event counters (the complement of
  46.           ----eeee).
  47.  
  48.      ----rrrr   Display event rates - this is the default.
  49.  
  50.      New information is reported each _i_n_t_e_r_v_a_l seconds.  The default is 5
  51.      seconds.
  52.  
  53.      For a particular processor implementation, the number of physical
  54.      hardware counters may be smaller than the number of event types that have
  55.      counting enabled.  When this occurs, the IRIX kernel multiplexes the
  56.      physical hardware counters amongst the enabled event counters, and
  57.      _e_c_s_t_a_t_s scales up the observed counts to reflect the level of
  58.      multiplexing.  If this scaling has taken place, the reported counters may
  59.      be subject to some statistical sampling errors, and the values are shown
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. EEEECCCCSSSSTTTTAAAATTTTSSSS((((1111))))                                                          EEEECCCCSSSSTTTTAAAATTTTSSSS((((1111))))
  71.  
  72.  
  73.  
  74.      with a ``*'' appended.
  75.  
  76. CCCCAAAAVVVVEEEEAAAATTTT
  77.      The underlying hardware event counters are a finite resource, to be
  78.      shared amongst multiple competing uses.  eeeeccccssssttttaaaattttssss is one such use that
  79.      requires the use of eeeeccccaaaaddddmmmmiiiinnnn(1) to enable at least one global event
  80.      counter.
  81.  
  82.      Once aaaannnnyyyy global event counters have been enabled with eeeeccccaaaaddddmmmmiiiinnnn(1), then
  83.      any future attempts to use either ppppeeeerrrrffffeeeexxxx(1) or the counter-based
  84.      SpeedShop profiling tools will be unsuccessful, until aaaallllllll global event
  85.      counters are released.
  86.  
  87. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  88.      eeeeccccaaaaddddmmmmiiiinnnn(1), ppppeeeerrrrffffeeeexxxx(1), ppppmmmmiiiinnnnffffoooo(1), ssssppppeeeeeeeeddddsssshhhhoooopppp(1) and rrrr11110000kkkk____ccccoooouuuunnnntttteeeerrrrssss(5).
  89.  
  90.      The specifications for the R10000 event counters may be found at
  91.      http://www.sgi.com/MIPS/products/r10k/Perf_Cnt/R10K_PF_Count.doc.html
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.